home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / ASSERT.z / ASSERT
Encoding:
Text File  |  1998-10-30  |  3.8 KB  |  66 lines
  1.  
  2.  
  3.  
  4. AAAASSSSSSSSEEEERRRRTTTT((((DDDD3333))))                                                          AAAASSSSSSSSEEEERRRRTTTT((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT - verify assertion
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_eeee_bbbb_uuuu_gggg_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _vvvv_oooo_iiii_dddd _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT_((((_iiii_nnnn_tttt _e_x_p_r_e_s_s_i_o_n_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _e_x_p_r_e_s_s_i_o_n
  18.                Expression to be evaluated.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT is a debugging interface for verifying program invariants within
  22.      code that is compiled with the _DDDD_EEEE_BBBB_UUUU_GGGG compilation option defined.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      If _e_x_p_r_e_s_s_i_o_n evaluates to non-zero, _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT returns no value.  If
  26.      _e_x_p_r_e_s_s_i_o_n evaluates to zero, _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT panics the system.
  27.  
  28. UUUUSSSSAAAAGGGGEEEE
  29.      _e_x_p_r_e_s_s_i_o_n is a boolean expression that the caller expects to evaluate to
  30.      non-zero (that is, the caller is asserting that the expression has a
  31.      non-zero value).  If _e_x_p_r_e_s_s_i_o_n evaluates to non-zero, the _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT call
  32.      has no effect.  If _e_x_p_r_e_s_s_i_o_n evaluates to zero, _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT causes the system
  33.      to panic with the following message:
  34.      _PPPP_AAAA_NNNN_IIII_CCCC_:::: _aaaa_ssss_ssss_eeee_rrrr_tttt_iiii_oooo_nnnn _ffff_aaaa_iiii_llll_eeee_dddd_:::: _e_x_p_r_e_s_s_i_o_n_,,,, _ffff_iiii_llll_eeee_:::: _f_i_l_e_n_a_m_e_,,,, _llll_iiii_nnnn_eeee_:::: _l_i_n_e_n_o
  35.  
  36.      where _f_i_l_e_n_a_m_e is the name of the source file in which the failed
  37.      assertion appears and _l_i_n_e_n_o is the line number of the _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT call within
  38.      the file.
  39.  
  40.      When the _DDDD_EEEE_BBBB_UUUU_GGGG compilation option is not defined, _AAAA_SSSS_SSSS_EEEE_RRRR_TTTT calls are not
  41.      compiled into the code, and therefore have no effect, including the fact
  42.      that _e_x_p_r_e_s_s_i_o_n is not evaluated.
  43.  
  44.    LLLLeeeevvvveeeellll
  45.      Initialization, Base or Interrupt.
  46.  
  47.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  48.      Does not sleep.
  49.  
  50.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  51.      across calls to this function.
  52.  
  53. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  54.      _cccc_mmmm_nnnn______eeee_rrrr_rrrr(D3)
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.